home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 9 / Night Owl CD-ROM (NOPV9) (Night Owl Publisher) (1993).ISO / 054a / dlgx12.zip / README.TXT < prev    next >
Text File  |  1993-02-14  |  17KB  |  428 lines
  1. WINDOWS DIALOG EXTENSIONS
  2.  
  3. Welcome to the Windows Dialog Extensions. This file gives details about
  4. installation and use of the programs and how to register if you find
  5. them useful.
  6.  
  7. Sections in this are document:-
  8.  
  9.    FILE PACKING LIST
  10.    HOW TO INSTALL THE WINDOWS DIALOG EXTENSIONS
  11.    ABOUT THE FILE DIALOG EXTENSIONS
  12.    ABOUT DIALOG 3D
  13.    HOW TO REGISTER THE WINDOWS DIALOG EXTENSIONS
  14.    DISCLAIMER AND AGREEMENT
  15.    NOTES
  16.    VERSION HISTORY
  17.  
  18.  
  19.  
  20. FILE PACKING LIST
  21.  
  22. Two utilities are provided as follows:-
  23.  
  24. Common File Dialog Extension Library (CFDEL)
  25.  
  26. This utility adds useful file manipulation buttons to file load and
  27. save dialogs in your windows apps (see below for full description)
  28.  
  29. Dialog 3d (Dialog3d)
  30.  
  31. This utility adds grey '3d style' dialogs (as in MS Excel 4 and Access)
  32. to all windows applications.
  33.  
  34.  
  35. You should have received the following files:-
  36.  
  37.    COMMDLG.DLL    The file extensions library
  38.    DIALOG3D.EXE   Dialog3d program
  39.    DLGCTRL.CPL    Control panel applet for Dialog3d
  40.    DETAILS.DLL    DLL containing common routines to above
  41.    DLG3D.DLL      Dilaog3d runtime library
  42.    CTL3D.DLL      Microsofts redistributable 3d library
  43.    CFDEL.HLP      Help for common file dialog extenders
  44.    REGISTER.HLP   Help file for registering
  45.    README.TXT     This file
  46.  
  47.  
  48.  
  49. HOW TO INSTALL THE WINDOWS DIALOG EXTENSIONS
  50.  
  51. Firstly the Windows Dialog Extensions require Windows 3.1 and will not
  52. work properly under 3.0.
  53.  
  54. Installation of the extensions must be done from DOS (not a DOS box
  55. under Windows) as follows:-
  56.  
  57. To install the Common File Dialog Extensions:-
  58.  
  59.    First, rename the file commdlg.dll in the Windows system
  60.    directory (usually c:\windows\system) to commdlg2.dll.
  61.  
  62.    Next copy the file commdlg.dll from the Dialog Extensions
  63.    distribution to the Windows system directory.
  64.  
  65.    Finally copy the files details.dll, register.hlp and cfdel.hlp 
  66.    from the Dialog Extensions distribution to the Windows directory
  67.    (usually c:\windows).
  68.  
  69. To install Dialog 3d:-
  70.  
  71.    Copy ctl3d.dll, dlgctrl.cpl and dlg3d.dll from the Dialog 
  72.    Extensions distribution to the Windows system directory.
  73.  
  74.    Copy dialog3d.exe, details.dll and register.hlp (if not copied 
  75.    above) to the Windows directory
  76.  
  77.    Add the program 'dialog3d.exe' as the first program in the 'run='
  78.    line of the win.ini file (found in the windows directory). Use any
  79.    ASCII text editor (notepad for example) to do this.
  80.  
  81. When you now run windows the Windows Dialog Extension will automatically
  82. be installed and activated.
  83.  
  84.  
  85.  
  86. ABOUT THE FILE DIALOG EXTENSIONS LIBRARY
  87.  
  88. The File Dialog Extensions attach a number of buttons to the bottom of
  89. a file load or save dialog from the commdlg.dll library supplied with
  90. Windows 3.1. Most Windows applications use this library for obtaining
  91. file names from the user. Thus when you got to load or save data from
  92. within an application the buttons will be available on the file dialog
  93. displayed allowing the manipulation of existing files without having to
  94. switch to the File Manager. The buttons that appear are configurable, as
  95. is the size that file dialogs are displayed. The buttons that may be
  96. added to the bottom of the file dialogs are:-
  97.  
  98.    Make Dir
  99.    Delete
  100.    Rename
  101.    File Info
  102.    Make Backup
  103.  
  104. The extensions library also adds new items to the System Menu of
  105. file dialogs. These entries are:-
  106.  
  107.    Make Directory...
  108.    Delete...
  109.    Rename...
  110.    File Info...
  111.    Make Backup
  112.    Options...
  113.    Help...
  114.    About...
  115.  
  116.  
  117. MAKE DIRECTORY BUTTON
  118.  
  119. Clicking on the Make Dir button will allow a directory to be created in
  120. the current directory (as displayed to the top right of the file dialog).
  121. You will be asked for the name of the directory, enter this and click OK to
  122. create it. If the directory is created successfully the file dialog will
  123. update to show the new directory. If an error occurs when trying to create
  124. the directory an error message box will be displayed. Click Cancel to exit
  125. the Make Directory dialog without attempting to create a directory.
  126.  
  127.  
  128. DELETE FILE BUTTON
  129.  
  130. Clicking on the Delete button will delete the currently selected file. This
  131. is the file highlighted in the file dialogs list of files. If no file is
  132. selected the Delete button will be disabled and no deletions can take place.
  133. If the Confirm Deletes option is enabled you will be asked for confirmation
  134. of the deletion, click Yes to delete or No to abort. If Confirm Deletes is
  135. not enabled the deletion will take place immediately after you click the
  136. Delete button. The file dialog file list will update after the deletion. An
  137. error message box will be displayed if the deletion fails.
  138.  
  139. If the application using the file dialog allows multiple files to be selected
  140. all the selected files will be deleted. If the Confirm Deletes option is
  141. enabled you will be prompted to confirm deletion for each file in turn.
  142. Selecting Cancel on a confirmation dialog will stop the deletion of the
  143. currently displayed file and all further selected files.
  144.  
  145.  
  146. RENAME FILE BUTTON
  147.  
  148. The Rename button allows the renaming of the currently selected file. This
  149. is the file highlighted in the file dialogs list of files. If no file is
  150. selected the Rename button will be disabled and no renaming can take place.
  151. Clicking on the Rename with a file selected results in a dialog asking for
  152. the new name for the file. This should be entered and OK selected to rename
  153. it. Click Cancel to abort renaming of the file. An error message box will
  154. be displayed if renaming of the file fails.
  155.  
  156. If the application using the file dialog allows multiple files to be selected
  157. you will be prompted for a new name for each selected file in turn. Click Yes
  158. to rename, No to skip to the next file and Cancel to cancel the renaming of
  159. the current and all further selected files
  160.  
  161.  
  162. FILE INFORMATION BUTTON
  163.  
  164. The File Info button will display information about the currently selected
  165. file. This is the file highlighted in the file dialog list of files. If no
  166. file is selected the File Info button will be disabled. The information
  167. displayed for a file is its name, size, time and date of last modification
  168. and its file attributes. This information is not editable. Click on OK when
  169. finished viewing the information.
  170.  
  171. If the application using the file dialog allows multiple files to be selected
  172. you will be shown details of each selected file in turn. Click OK to move to
  173. the next file and {\cf1Cancel\cf0} to stop viewing the selected list of files.
  174.  
  175.  
  176. MAKE BACKUP CHECKBOX
  177.  
  178. The Make Backup checkbox is only enabled when saving. If it is checked
  179. before selecting OK to save a file, a backup will be made of any existing
  180. file with a name matching that of the file being saved. This is done by
  181. copying the existing file to a similarly named file with the extension .BAK.
  182. An error message box will be displayed if the backup fails.
  183.  
  184.  
  185. NEW SYSTEM MENU ITEMS
  186.  
  187. The first five new system menu items duplicate the buttons described above
  188.  
  189.  
  190. OPTIONS DIALOG
  191.  
  192. Selecting Options... from the System Menu of a file load or save dialog
  193. will bring up the file extensions Options dialog box. This dialog allow the
  194. customisation of the extensions and covers three areas. Firstly, the Show
  195. checkboxes control which of the possible five extension buttons are added
  196. to file dialogs. The next section is the Options checkboxes. Currently this
  197. has one checkbox allowing the enabling or disabling of the Confirm Deletes
  198. dialog when deleting files. The final set of buttons allow the selecting of
  199. the dialog size. This may be Small, Medium or Large. Small is the same as
  200. the standard commdlg.dll file dialog, Medium has two columns in the file
  201. list box and is slightly deeper and Large is almost full screen on a VGA
  202. monitor and gives three columns in the file list box.
  203.  
  204. Note that the file list on the medium or large settings is a multi-column
  205. list and you scroll it horizontally to display any files 'off screen'.
  206.  
  207. Sometimes you will find the size buttons disabled (shown shaded), this
  208. occurs when the library is being used with an application that supplies
  209. its own dialog template rather than using the one in commdlg.dll. Because
  210. of this the extensions library doesn't know what the dialog will look like
  211. and so does not attempt to resize it and also disables disables the size
  212. buttons on the Options dialog when called from such a file dialog. The
  213. library still attaches the file buttons to the bottom of such a dialog
  214. and these can be used as normal.
  215.  
  216. Click OK to set the selected options and Cancel to ignore the changes.
  217.  
  218. The options selected in the dialog are saved in a section in the win.ini
  219. file and will be used in later windows sessions.
  220.  
  221.  
  222. HELP
  223.  
  224. Selecting Help... from the System Menu give help on the common dialog
  225. extensions facilities in the standard Windows format.
  226.  
  227.  
  228. ABOUT DIALOG
  229.  
  230. Selecting About... from the System Menu of a file load or save dialog will
  231. bring up the file extensions About dialog box. If the copy is registered it
  232. will show the registered user and serial number. If it is unregistered it
  233. will show *** UNREGISTERED COPY *** and Serial Number : XXXXXX. Clicking
  234. OK on an unregistered copy of the extensions will result in the Shareware
  235. Reminder dialog being shown, offering the user the chance to register the
  236. program. Clicking OK on a registered copy simply returns to the file dialog.
  237.  
  238.  
  239.  
  240. ABOUT DIALOG 3D
  241.  
  242. Dialog 3d is now supplied with a control panel applet to allow you to 
  243. select different dialog 'looks'. If dlgctrl.cpl is installed as described
  244. above when you run control panel there will be a new applet icon '3D'.
  245. Double clicking on this will give you a dialog with options for 
  246. enable/disable 3d dialogs, dialog border style and dialog background 
  247. style. After choosing your desired 'look' click on OK and this will become
  248. active for all subsequent dialogs.
  249.  
  250. If you'd prefer a colour other than grey alter the Windows 'Button Face'
  251. system colour (use the colour applet from the control panel) and this will
  252. become the background colour of your dialogs.
  253.  
  254.  
  255.  
  256. HOW TO REGISTER THE WINDOWS DIALOG EXTENSIONS
  257.  
  258. Registration and initial support contact for this software is handled by
  259. the software publishers SP Services. A wide variety of payment options
  260. are available; choose the method most convenient to you. Please note that
  261. payment is required with order except from UK government organisations
  262. and UK plc companies, who may request invoicing at an additional charge of
  263. 5 pounds per month unpaid after 30 days.
  264.  
  265. To register a copy of the file dialog extenders send your name and address
  266. plus either a Cheque, Postal Order or International Money Order for the
  267. required sum, made payable to SP Services, or your Visa, Mastercard or
  268. American Express number plus the card expiry date, to:-
  269.  
  270.    SP Services
  271.    PO Box 456
  272.    Southampton
  273.    SO9 7XG
  274.    United Kingdom
  275.  
  276. or fax the card number, expiry & address details to  0703 550037
  277. (international:  +44 703 550037), or send them by e-mail to
  278. sphipps@cix.compulink.co.uk or to account 100016,1625 on CompuServe, or
  279. transfer sterling funds pre-paid to the following account:
  280.  
  281. Royal Bank of Scotland, 1 College Place, Southampton,
  282. Sort code 16-31-37, account 00237689, name SP Services
  283.  
  284. Payment may be made (fully pre-paid please) in US dollars to account
  285. number SPSERV-USDC at the same bank.  If you use bank transfer,
  286. please also fax or mail confirmation of the transfer and order.
  287.  
  288. Pricing for the file dialog extenders is a follows:-
  289.  
  290.    Up to 5 copies    10.00 pounds each
  291.    6-10 copies        8.50 pounds each
  292.    over 10 copies     8.00 pounds each
  293.  
  294. All credit card payments are charged in pounds sterling; conveniently, your
  295. credit card company conduct all the messy business of currency exchange for
  296. you at relatively low cost.
  297.  
  298. Cheque, postal order and bank draft payment may be made in pounds sterling or
  299. US dollars, pricing in dollars to be calculated at 2 dollars to the pound.
  300. Please indicate whether you need a receipt when you order.  VAT is not charged
  301. by SP Services at this time.
  302.  
  303. You can calculate the price for the number of copies required by entering the
  304. number of copies you require into the 'copies' field on the programs
  305. Registration dialog. The price will then be displayed on the dialog.
  306.  
  307. When you receive your registration details enter the name, registration number
  308. and serial number as supplied into the appropriate fields on the Registration
  309. dialog and click on OK. These must be entered exactly as supplied. Once
  310. entered successfully the Shareware reminder and timeout will be disabled and
  311. your name and serial number will appear on the About dialog box.
  312.  
  313. You get the registration dialog by selecting the Register button from the
  314. Shareware Reminder dialog box. This will appear after closing the About dialog
  315. on an unregistered copy of the program. The About dialog is available from the
  316. system menu of a file open or close dialog of an application (that uses
  317. commdlg.dll) when the File Dialog Extensions are installed.
  318.  
  319.  
  320. NOTE ON CREDIT CARDS
  321.  
  322. If paying with credit card via mail or fax please include your signature on
  323. your registration request.  We sadly cannot accept credit card payments if
  324. yours is a PO Box address.  Please ensure the address you cite is the same
  325. one your credit card statements are sent to.  All these conditions are
  326. imposed by our bank and are outside our control - sorry.
  327.  
  328.  
  329.  
  330. DISCLAIMER AND AGREEMENT
  331.  
  332. Users of the Windows Dialog Extensions must accept this disclaimer of
  333. warranty. If you do not accept this disclaimer, do not use the programs.
  334.  
  335. THE WINDOWS DIALOG EXTENSIONS LIBRARY IS SUPPLIED AS IS. THE AUTHOR
  336. DISCLAIMS ALL WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, WITHOUT
  337. LIMITATION, THE WARRANTIES OF MERCHANTABILITY AND OF FITNESS FOR ANY
  338. PURPOSE. THE AUTHOR ASSUMES NO LIABILITY FOR DAMAGES, DIRECT OR
  339. CONSEQUENTIAL, WHICH MAY RESULT FROM THE USE OF THE WINDOWS DIALOG
  340. EXTENSIONS, EVEN IF THE AUTHOR HAS BEEN ADVISED OF THE POSSIBILITY
  341. OF SUCH DAMAGES.
  342.  
  343. THE LICENCE AGREEMENT AND WARRANTY SHALL BE CONSTRUED, INTERPRETED AND
  344. GOVERNED BY THE LAWS OF ENGLAND AND WALES. YOU MAY HAVE OTHER RIGHTS
  345. WHICH VARY FROM ONE STATE TO ANOTHER.
  346.  
  347. The Windows Dialog Extensions are shareware, and are provided at no charge
  348. to users for evaluation. Feel free to share it with your friends and
  349. colleagues, but please do not give it away altered or as part of another
  350. system. The essence of shareware software is to provide computer users
  351. with quality software without high prices, and at the same time to
  352. provide incentive for programmers to continue to develop new products.
  353.  
  354. If you find the Windows Dialog Extensions useful, and you are continuing
  355. to use it after the trial period of 28 days, you must make a registration
  356. payment as indicated in the How to Register section of this document. In
  357. return you will be given a user name, serial number and registration
  358. number to disable the shareware reminders. This information will be good
  359. for all future shareware releases of the extensions. You will be informed
  360. when such releases become available.
  361.  
  362. A site licence for over 10 copies may be obtained at a reduced cost by
  363. contacting SP Services by post or email.
  364.  
  365. Any person or organisation wanting to distribute the File Dialog Extensions
  366. for profit must first contact SP Services by post or email for authorisation.
  367.  
  368.  
  369. Copyright for this software remains the property of:
  370.  
  371.    Mark Woollard
  372.    29 Baskerville Lane
  373.    Lower Shiplake
  374.    Henley-on-Thames
  375.    Oxon RG9 3JY
  376.    United Kingdom
  377.  
  378. All contact should be made with SP Services in the first instance.
  379.  
  380.  
  381. Windows is a registered trademark of Microsoft Corporation.
  382.  
  383.  
  384.  
  385. NOTES
  386.  
  387. Dialog3d has no effect with Microsoft Word. This is because MS Word does not
  388. use the standard Windows dialog routines but its own internal routines and
  389. methods to achieve the same result.
  390.  
  391.  
  392.  
  393. VERSION HISTORY
  394.  
  395. Windows Dialog Extenders Bundle
  396.  
  397. 11/1/93            First release
  398. 14/2/93            Second release
  399.  
  400.  
  401. Common File Dialog Extensions
  402.  
  403. 21/11/92   V1.0  - First release
  404. 23/11/92   V1.0a - Fix for problems with Rename error dialogs
  405. 24/11/92   V1.0b - Fix for problems with Make Dir, timeout increased
  406.                    to 45 mins
  407. 30/11/92   V1.0c - Timeout removed and replaced with occasional
  408.                    reminder dialogs
  409. 22/12/92   V1.0d - Fix for problems with PM and FM browse dialogs
  410. 23/12/92   V1.0e - Fix for problems with MS QuickC for Windows edit
  411.                    project dialog
  412. 9/1/93     V1.1  - Support for multi selection dialogs and addition
  413.                    of help menu entry. Now bundled with Dialog3d as
  414.                    Windows Dialog Extensions
  415. 14/2/93    V1.2  - Editable file attributes, buttons duplicated on system
  416.                    menu + fixes for problems reported to date.
  417.  
  418. Dialog 3D
  419.  
  420. 3/1/93     V1.0  - Initial release
  421. 5/1/93     V1.0a - Sorts out problems with SS_SIMPLE Static controls +
  422.                    works with MS access.
  423. 11/1/93    V1.0b - Bundled with Dialog3d as Windows Dialog Extensions, fix
  424.                    for static controls with < 256 chars (bypasses bug in
  425.                    ctl3d).
  426. 14/2/93    V1.1  - Now offers choice of dialog 'looks' selectable through
  427.                    control panel applet.
  428.